The textarea element represents a multiline plain text edit
control for the element's raw
value. The contents of the control represent the control's default value.
| Properties |
|---|
| DOMString | - autocomplete
- The autocomplete IDL attribute, on getting,
must return the element's IDL-exposed autofill value, and on setting, must
reflect the content attribute of the same name.
|
| boolean | - autofocus
- The autofocus IDL attribute must
reflect the content attribute of the same name.
|
| unsigned long | - cols
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| DOMString | - defaultValue
- The defaultValue IDL attribute must
act like the element's textContent IDL attribute.
|
| DOMString | - dirName
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| boolean | - disabled
- The disabled IDL attribute must
reflect the disabled content attribute.
|
| HTMLFormElement? | - form
- Reassociateable form-associated elements have a form
IDL attribute, which, on getting, must return the element's form owner, or null if
there isn't one.
|
| DOMString | - inputMode
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| NodeList | - labels
- Labelable elements have a NodeList object
associated with them that represents the list of label elements, in tree
order, whose labeled control is the element in question. The labels IDL attribute of labelable elements, on getting, must return that
NodeList object.
|
| long | - maxLength
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| long | - minLength
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| DOMString | - name
- The name IDL attribute must reflect
the name content attribute.
|
| DOMString | - placeholder
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| boolean | - readOnly
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| boolean | - required
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| unsigned long | - rows
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| DOMString | - selectionDirection
- The selectionDirection
attribute must, on getting, return the string corresponding to the current selection direction: if
the direction is forward, "forward"; if the direction is
backward, "backward"; and otherwise, "none".
|
| unsigned long | - selectionEnd
- The selectionEnd attribute
must, on getting, return the offset (in logical order) to the character that immediately follows
the end of the selection. If there is no selection, then it must return the offset (in logical
order) to the character that immediately follows the text entry cursor.
|
| unsigned long | - selectionStart
- The selectionStart attribute
must, on getting, return the offset (in logical order) to the character that immediately follows
the start of the selection. If there is no selection, then it must return the offset (in logical
order) to the character that immediately follows the text entry cursor.
|
| unsigned long | - textLength
- The textLength IDL attribute must
return the code-unit length of the element's API value.
|
| DOMString | - type
- The type IDL attribute must return the value
"textarea".
|
| DOMString | - validationMessage
- The validationMessage attribute must
return the empty string if the element is not a candidate for constraint validation
or if it is one but it satisfies its constraints; otherwise,
it must return a suitably localized message that the user agent would show the user if this were
the only form control with a validity constraint problem.
|
| ValidityState | - validity
- The validity attribute must return a
ValidityState object that represents the validity states of the element. This object is live, and the same object must be returned each time the element's
validity attribute is retrieved.
|
| DOMString | - value
- The value attribute must, on getting, return
the element's API value; on setting, it must set
the element's raw value to the new value, set the
element's dirty value flag to true, and should then
move the text entry cursor position to the end of the text field, unselecting any selected text
and resetting the selection direction to none.
|
| boolean | - willValidate
- The willValidate attribute must return
true if an element is a candidate for constraint validation, and false otherwise
(i.e. false if any conditions are barring it from
constraint validation).
|
| DOMString | - wrap
- The cols, placeholder, required, rows, and wrap attributes must reflect the
respective content attributes of the same name. The cols
and rows attributes are limited to only non-negative
numbers greater than zero. The cols attribute's
default value is 20.
|
| Operations |
|---|
| boolean | - checkValidity()
- When the checkValidity() method is
invoked, if the element is a candidate for constraint validation and does not satisfy its constraints, the user agent must fire a simple
event named invalid that is cancelable (but in this case
has no default action) at the element and return false.
|
| boolean | - reportValidity()
- When the reportValidity() method is
invoked, if the element is a candidate for constraint validation and does not satisfy its constraints, the user agent must: fire a simple
event named invalid that is cancelable at the element,
and if that event is not canceled, report the problems with the constraints of that element to the
user; then, return false.
|
| void | - select()
- The select() method must cause the
contents of the text field to be fully selected, with the selection direction being none, if the
platform support selections with the direction none, or otherwise forward. The user
agent must then queue a task to fire a simple event that bubbles named
select at the element, using the user interaction task
source as the task source.
|
| void | - setCustomValidity(DOMString error)
- The setCustomValidity(message), when invoked, must set the custom validity error
message to the value of the given message argument.
|
| void | setRangeText(DOMString replacement, optional unsigned long start, optional unsigned long end, optional SelectionMode selectionMode) |
| void | - setSelectionRange(unsigned long start, unsigned long end, optional DOMString direction)
- The setSelectionRange(start, end, direction) method
must set the selection of the text field to the sequence of characters starting with the character
at the startth position (in logical order) and ending with the character at
the (end-1)th position. Arguments greater than the
length of the value of the text field must be treated as pointing at the end of the text field.
|